home *** CD-ROM | disk | FTP | other *** search
/ Linux 68k 2000 / Linux 68k 2000.iso / install / atari / INSTALL.DOC < prev    next >
Encoding:
Text File  |  1999-05-27  |  24.9 KB  |  492 lines
  1.  
  2.                             Debian/m68k GNU/Linux
  3.  
  4.                   Installation Instructions for Atari (v1.5)
  5.  
  6.                        Michael Schmitz, February 8, 1999
  7.  
  8.                (derived from Amiga install guide by Frank Neumann)
  9.      _____________________________________________________________________
  10.  
  11.    A hopefully always up-to-date version of this document should be online at 
  12.    the Debian/68k web site.
  13.  
  14.     Ok, so you think you want to try Debian, dive into the wonderful world of 
  15.    free software, world-wide programming collaboration and soon-to-come world 
  16.    domination? Fine. Your first test will be to install the Debian base system 
  17.    on your Atari, and I hope this document will help you in getting that step 
  18.    done.
  19.  
  20.     So, without any further ado, these are the absolutely vital steps you need 
  21.    to take:
  22.  
  23.     0) Before even thinking of starting to install Debian on your Atari, you 
  24.    should make a BACKUP of your current system. It's not like Debian will erase 
  25.    all data on your harddisks immediately when it starts up, but you can damage 
  26.    a lot easily if you are new to Linux or Unix in general. If you have a DAT, 
  27.    MO or spare harddisk, this is the chance to use them for creating a backup.
  28.  
  29.     0b) Check out if your system is suited for Linux/m68k - please read the 
  30.    Linux/m68k FAQ, available e.g. at http://www.linux-m68k.org.
  31.  
  32.     1) Get all required files from one of Debian's FTP sites, like 
  33.    ftp.debian.org, ftp.de.debian.org etc. A list of mirror sites can be found 
  34.    at http://www.debian.org/distrib/ftplist.
  35.    
  36.     No matter what mirror site you use, the path should always be:
  37.    /pub/debian/dists/slink/main/disks-m68k/current
  38.    These are the files you need:
  39.      * atari/install.lzh (around 2.8 MB), or
  40.      * atari/resc1440.bin ('rescue' floppy image),
  41.      * atari/drv1440.bin ('drivers' floppy image), and
  42.      * common/base2_1.tgz
  43.  
  44.    If you chose to install from the resc1440.bin floppy image, you'll also need 
  45.    a program to dump the floppy image to a 1440k (HD) floppy in your A: drive. 
  46.    That program, rawwrite.ttp, is currently available from
  47.  
  48.    /pub/debian/dists/hamm/disks-m68k/1998-03-10/atari/
  49.  
  50.    on the Debian mirror site you used. It should be eventually moved into the 
  51.    new Atari install dir. If you had to compress the floppy images for transport 
  52.    to your Atari, you might find the gzip.ttp uncompressor in that directory 
  53.    useful as well.
  54.  
  55.    Once you have installed the base system and want to continue installing other 
  56.    packages, you can find these under the directories
  57.    /pub/debian/dists/slink/main/binary-m68k (core section),
  58.    /pub/debian/dists/slink/contrib/binary-m68k (contributed packages)
  59.    and
  60.    /pub/debian/dists/slink/non-free/binary-m68k (software which does not meet the 
  61.    Debian Free Software Guidelines (DFSG)).
  62.  
  63.    Alternatively, get the official Debian/68k 2.1 CD set. The install files
  64.    are unpacked on disc 1 in /install/atari/, the LZH archive and base2_1.tgz 
  65.    are in /install/.
  66.  
  67.     2) Unpack the install.lha file to your harddisk (a subdirectory named 
  68.    "debian" will be automatically created for you). I recommend to unpack the 
  69.    archive directly onto the main directory of a partition that has at least 
  70.    ~ 10 MB of free space.
  71.    Move the base2_1.tgz, resc1440.bin and drv1440.bin files into this same 
  72.    directory ("debian"). Don't rename any files in that directory.
  73.  
  74.    When installing from CD, either unpack /install/atariinstall.lzh to your
  75.    harddisk as described above, or try using the files in /install/atari/
  76.    directly. 
  77.    
  78.     3) Partition your harddisk (or rather prepare partitions for Linux):
  79.    There is a partitioning tool for Linux/m68k called atari-fdisk, but for now 
  80.    I recommend you partition your disk using a TOS partition editor or some disk 
  81.    tool. If your partition editor doesn't have an option to edit the partition 
  82.    type, you can do this crucial step at a later stage (from the booted temporary 
  83.    install ramdisk). One of the partition editors supporting selection of 
  84.    arbitrary partition types is SCSITool (Hard&Soft). There will be others, 
  85.    select one to suit your need. 
  86.  
  87.    You should have reserved at least two partitions for Linux: One for the "root 
  88.    filesystem" and one for a "swap partition". The size recommendations are:
  89.  
  90.      for the root partition:
  91.  
  92.      * absolute minimum should be 25 MB (this is just enough to install the 
  93.        base system, and nothing else - probably enough for testing it, but 
  94.        not for really using it)
  95.      * a reasonable system starts at around 200 - 400 MB, no limits upwards.
  96.  
  97.      for the swap partition: about twice as large as your main memory, but 
  98.    rather more than that. Especially on systems with little main memory (like 
  99.    8 MB RAM), don't go below 20 MB swap space. Naming conventions: This is 
  100.    important because under Linux your partitions have different names than 
  101.    under TOS. This is the naming scheme:
  102.      * The first SCSI harddisk (address-wise) is named "sda".
  103.      * The second SCSI harddisk (address-wise) is named "sdb", and so on.
  104.      * The first IDE harddisk is named "hda", the second IDE harddisk is 
  105.        named "hdb", and so on.
  106.  
  107.    The partitions on each harddisk are represented by appending a decimal 
  108.    number to the harddisk name: sda1, sda2, sda3 represent the first, second 
  109.    and third partition of the first SCSI harddisk in your system.
  110.  
  111.     Here is a real-life example: Let's assume you have a system with 2 SCSI 
  112.    harddisks, one at SCSI address 2 and the other at SCSI address 4. The first 
  113.    disk (at address 2) is then named "sda", and the second "sdb". If the "sda"
  114.    harddisk has 5 partitions on it, these will be named "sda1", "sda2", ..., 
  115.    "sda5". Analoguous for the "sdb" harddisk and its partitions.
  116.  
  117.     So, now that we know the partition names, you can actually change their 
  118.    type from within your partition editor so that the Linux installation 
  119.    program can detect them:
  120.  
  121.     Start the partition editor, select the disk you want to use, select the 
  122.    "Partition Drive" function and select/create the partition you want to use 
  123.    as the Debian root filesystem. If there is a partition ID option, select it 
  124.    and enter LNX as the partition ID.
  125.  
  126.     After having done this, select a partition that is to be used as a swap 
  127.    partition, and repeat the same steps as above, but set the identifier to 
  128.    SWP instead.
  129.  
  130.    The following example covers 'SCSITool':
  131.                                                                  
  132.      1.   Start SCSITool, select the disk you want to partition ('Disk' menu,
  133.           item 'select').                                        
  134.  
  135.      2.   From the 'Partition' menu, select either 'New' to add new
  136.           partitions or change the existing partition sizes, or 'Change' to
  137.           change one specific partition. Unless you have already created
  138.           partitions with the right sizes and only want to change the
  139.           partition ID, 'New' is probably the best choice.
  140.                                                                  
  141.      3.   For the 'New' choice, select 'existing' in the dialog box
  142.           prompting the initial settings. The next window shows a list
  143.           of existing partitions which you can adjust using the scroll
  144.           buttons, or by clicking in the bar graphs. The first column in
  145.           the partition list is the partition type, just click on the text
  146.           field to edit.                                         
  147.           When you are finished changing partition settings, save the
  148.           changes by leaving the window with the 'Ok' button.
  149.                                                                  
  150.      4.   For the 'Change' option, select the partition to change in the
  151.           selection list, and select 'other systems' in the dialog box.
  152.           The next window lists detailed information about the location of
  153.           this partition, and lets you change the partition ID. Again, save
  154.           the changes by leaving the window with the 'Ok' button.
  155.  
  156.      5.   Write down the Linux names for each of the partitions you created
  157.           or changed for use with Linux - see section 4.2 for the naming
  158.           scheme. 
  159.  
  160.      6.   Quit SCSITool using the 'Quit' option from the 'File' menu, the 
  161.           computer will reboot to make sure the changed partition table is
  162.           used by TOS. If you changed any TOS/GEM partitions, they will be 
  163.           invalidated and have to be reinitialized (we told you to back up
  164.           everything on the disk, didn't we?).
  165.  
  166.     Please note:
  167.      * Your root and swap partitions do not need to be on the same harddisk.
  168.      * You can have more than one partition for files besides the root 
  169.        filesystem - this even makes sense very often, like when seperating the 
  170.        user's home directories from the system file area. If you want to use 
  171.        more partitions, prepare them just like the root partition.
  172.        If you're only going to try Linux for a short time, it's enough to just 
  173.        have a single partition for files.
  174.      * You can also have more than one swap partition, though that's not seen 
  175.        very often.
  176.      * Write down the partition names (you know, the "sda1" etc. stuff) of all 
  177.        partitions that you are going to use for Linux.
  178.      * At this point, please also write down the partition name (Linux-wise) of 
  179.        the partition on which you have unpacked the "install.lha" archive. You 
  180.        will need this later for installation of the kernel, modules and base 
  181.        system.
  182.  
  183.    When you have made all required changes, go back to the main window of the 
  184.    partition editor by "Save Changes to drive" or "Ok". Think twice before 
  185.    actually clicking on "Yes" to confirm the changes - have you chosen the 
  186.    correct partitions? No viable data that could get lost now? Then click OK.
  187.    If required, the Atari will reboot after this.
  188.  
  189.     5) When you're back at the GEM desktop, start the Linux installation process 
  190.    by double-clicking on the "BOOTSTRA.PRG" icon in the "debian" directory, or
  191.    in the /install/atari/ directory on the CD. If installing from floppies, 
  192.    double-click on the  "BOOTSTRA.TTP" icon, or the "BOOTSTRA.PRG" icon in the 
  193.    "AUTO" folder instead. BOOTSTRA.TTP will prompt for parameters, simply hit 
  194.    <return> for now.
  195.  
  196.     You may have to press the <Return> key after the bootstrap program has output 
  197.    some debugging information. After this, the screen will go grey, a few seconds 
  198.    of delay, and after that a black screen with white text should come up, 
  199.    displaying all kinds of kernel debugging information. These scroll by far too 
  200.    fast for you to read, but that's not important right now.
  201.    After a couple of seconds, the installation program should start automatically.
  202.    If you get up to this point, you can be quite confident that you will be able 
  203.    to install Linux on your system.
  204.  
  205.     6) So, now we're getting somewhere. The Debian installation program will 
  206.    lead you through the steps of preparing the partitions from the Linux side, 
  207.    unpacking and configuring the kernel modules and base system, and finally 
  208.    rebooting. Some of the presented steps are not really necessary (or even 
  209.    possible) on m68k platforms (the installation program is just the same as 
  210.    on the i386 version of Debian, and some of the i386 features are not (yet) 
  211.    available in the m68k version), so I'll tell you what you have to do at 
  212.    each step now.
  213.  
  214.  
  215.   Select Color or Monochrome display
  216.  
  217.    If you use an SM124 or TT monitor, you might want to choose a monochrome 
  218.    display - otherwise select Color. Use the cursor keys to choose what you 
  219.    want, then press <Return>.
  220.  
  221.  
  222.   Release notes
  223.  
  224.    This is just a screen with a few informations about Debian's goals, who 
  225.    built the rescue set etc.
  226.  
  227.     Now we come to the main installation screen which lists all possible actions 
  228.    you can take, with the next logical step always being highlit at the top of 
  229.    the list. I recommend to strictly follow the suggested way.
  230.  
  231.  
  232.   Configure the keyboard
  233.   
  234.    Depending on whether you have a U.S. or german or other keyboard, select the 
  235.    one appropriate for you with the cursor keys and Space, then move with <Tab> 
  236.    to the OK button and press <Return>.
  237.  
  238.  
  239.   Initialize and Activate a Swap Partition
  240.  
  241.    When pressing <Return>, you will see a list of partitions that the installation 
  242.    program has found as being prepared by you for usage as a swap partition. 
  243.    Probably there is only one choice, and it should have the same partition name 
  244.    you wrote down under TOS while you were preparing that partition in your disk 
  245.    utility. If you have chosen to use several swap partitions, repeat the 
  246.    following step for all of them:
  247.      * Press <Return> to accept the selected partition
  248.      * When asked whether you want to do a bad-block scan, you can safely skip 
  249.        this step, so select "No" here using <Tab> and then <Return>.
  250.      * When asked whether you really want to initialize this partition as a 
  251.        swap partition, think twice, then, when being sure, press <Return>.
  252.  
  253.    At this point the swap partition will be "formatted" -- that is, some 
  254.    information is written to it to mark it as swap partition -- which only 
  255.    takes a second (you'll hardly be able to read the text that appears at the 
  256.    top of the screen - ignore that for now).
  257.  
  258.  
  259.   Initialize a Linux partition
  260.  
  261.    This is very similar to the previous step, but this time it's not about swap 
  262.    partitions, but about "real" partitions which are supposed to carry files. 
  263.    Just as before, you'll be presented with a list of partitions that the 
  264.    installer found to be valid as Linux filesystem partitions.
  265.    Again, for each of the partitions you have chosen to use, accept it by 
  266.    selecting it from the list and pressing <Return>, skip the "Bad-block scan" 
  267.    and (when you are sure) select "Yes" to format (initialize) the partition. 
  268.    After that, you will be asked whether you want to mount the currently active 
  269.    partition as root ("/") partition. Say "Yes" here at the first partition you 
  270.    use. Other partitions can be mounted somewhere under this mount point
  271.    afterwards.
  272.  
  273.  
  274.   Install Operating System Kernel and Modules
  275.  
  276.    As I assume that you are installing from files on a harddisk, you will have 
  277.    to select "Harddisk: Filesystem on the harddisk" here.
  278.    Next you need to specify the (TOS) partition on which you unpacked the 
  279.    "install.lha" archive. After that you also need to enter the path to the 
  280.    directory containing the installation files - in the simplest case (that is, 
  281.    if you unpacked the .lha archive directly into the main directory of a 
  282.    partition), you just hit <Return> because "/debian" is already set as default 
  283.    for the directory name; otherwise you will have to type the path yourself. 
  284.    It has to begin with a "/", followed by the directory components leading to 
  285.    the files (e.g. "/tmp/newstuff/debian" if the files reside in the directory 
  286.    /tmp/newstuff/debian/ on that partition). 
  287.    If installing from CD, select "cdrom: CD-ROM drive" and change "/debian" to 
  288.    "/install/atari" at the path prompt. 
  289.    Next you are asked whether you want to select the files from a list or enter 
  290.    the path name manually; just press <Return> here twice as the installation 
  291.    program will find the correct and only available installation files itself.
  292.  
  293.     The harddisk LED will blink for a while as the kernel and modules are 
  294.    unpacked onto the root partition, and after that you get back to the main 
  295.    screen.
  296.  
  297.    If you are installing from floppy images you dumped on two blank floppies, 
  298.    select "/dev/fd0: First floppy drive", and the kernel will be copied to the 
  299.    root partition from the floppy you used to start up the install. After 
  300.    installation of the kernel, the installer will ask you to insert the drivers 
  301.    floppy (the one you created by dumping the drv1440.bin image). Change the 
  302.    floppies, press <Return> when ready and the installer will continue by 
  303.    extracting the device driver modules onto the root partition.
  304.  
  305.  
  306.   Configure Device Driver Modules
  307.  
  308.    This step is only necessary if certain device drivers need to be loaded very 
  309.    early when Linux starts up later; like, an Ethernet driver has to be pre-
  310.    loaded so that the networking can already be initialized at boot-time. For a
  311.    stand-alone system you probably don't have to configure anything here, but 
  312.    you should still select this item so that the installer can build a list of 
  313.    available kernel modules. When you see the next screen, you can immediately 
  314.    go to "Exit: Finished with modules. Return to previous menu".
  315.  
  316.     If you do need to configure a device driver for your system, please follow 
  317.    the on-screen explanations for selecting modules to be pre-loaded (this 
  318.    section is a bit short right now, sorry). When done, select the "Exit" item.
  319.  
  320.     Once your Linux system is installed, you can get back to the configuration 
  321.    of modules at any time by starting the "modconf" program.
  322.  
  323.  
  324.   Configure the Network
  325.  
  326.    This last step is to set up your networking if you are so lucky to be 
  327.    connected to a net. If you have no network, all you need to enter is your 
  328.    hostname (under Linux, every computer has a name!). Pick something you like 
  329.    - your girlfriend's name *sigh*, a famous artist/writer/composer/character/
  330.    actor/whatever. Just one word, please.
  331.  
  332.     If you are connected to a network, you need to enter:
  333.      * Your network's name
  334.      * The IP address of your computer
  335.      * The netmask
  336.      * Your broadcast address
  337.      * Your gateway's IP address, if one is available
  338.      * Your nameserver's IP address, if there is one available.
  339.      * Your type of connection - Ethernet, PPP, Slip or whatever else.
  340.  
  341.    The help screen on this step suggests that you don't answer "Yes" to the 
  342.    question whether your computer is connected to a network if this connection 
  343.    is PPP, i.e. a temporary one (makes sense, as PPP is often assigned dynamic
  344.    network addresses). I strongly recommend to follow this suggestion and
  345.    complete the network configuration after booting the disk based system. 
  346.    The 'pppconfig' utility is included in the base system to this purpose.
  347.  
  348.    In case you complete the network configuration here, this step doesn't 
  349.    completely set up PPP or SLIP for you, just stores some configuration data 
  350.    for you. For these configurations, you'll see error messages about 'network 
  351.    device not available' now (and on the later boot from disk), ignore them, 
  352.    and configure PPP or SLIP later.
  353.  
  354.  
  355.   Install the Base System
  356.  
  357.    Just as with the "Install Operating System Kernel and Modules" step, you need 
  358.    to specify where the base system archive is located. This file should be 
  359.    named "base2_1.tgz". If you have put it into the same directory as the other
  360.    installation files, you already know what to do now: Select "harddisk: 
  361.    Filesystem on the harddisk", pick the correct partition and (if necessary) 
  362.    enter the path name to the directory containing those files. If you are 
  363.    installing from CD, select "cdrom: CD-ROM drive" and enter "/install" as path. 
  364.    Again, as everything should be in the place the installer expects to find it, 
  365.    press <Return> twice after this to accept the default options.
  366.  
  367.     At this point you've got a few minutes time (depending on the speed of your 
  368.    processor/harddisk) while the base archive is unpacked onto the Linux root 
  369.    partition.
  370.  
  371.  
  372.   Configure the Base System
  373.  
  374.    In this step you just set the timezone that you're in - this should be 
  375.    pretty intuitive. For instance, for Germany the selection "CET - Europe" 
  376.    (first screen) and "Berlin" (second screen) should be fine.  When asked 
  377.    whether your system clock is set to "GMT" (Greenwich Mean Time), you will 
  378.    likely answer with "No" as most Ataris will use the local time instead of 
  379.    GMT.
  380.  
  381.  
  382.    Well, that's it! Ignore the next suggested step ("Make Linux bootable 
  383.    directly from harddisk") and instead select alternative 2: "Reboot the 
  384.    System". After a few seconds, the Atari should reboot automatically into 
  385.    TOS/GEM.
  386.  
  387.     So, one last step is required from you before you can boot your freshly 
  388.    installed Linux: Go to the directory containing the installation files and 
  389.    start up a texteditor into which you need to enter just one line:
  390.  
  391.     -k linux root=/dev/yyyy video=keep
  392.  
  393.    In this line, replace the
  394.  
  395.    yyyy
  396.  
  397.    with the Linux partition name of the root partition onto which you installed 
  398.    the system - like sda1, hdb3, whatever it was, you figure. The 'video=keep' 
  399.    is my recommendation especially for Falcon users with screen extenders and 
  400.    the like; please keep in mind that high screen resolution and high color 
  401.    seriously impairs SCSI performance on these machines.
  402.    External graphics cards need a special 'video=external' option, refer to the 
  403.    kernel options documentation for details.
  404.  
  405.     Save that file, naming it "bootargs".
  406.  
  407.    If you installed from floppy disks, copy "bootstra.prg" and "linux" to a 
  408.    folder on your harddrive, and create the "bootargs" file as above.
  409.  
  410.     Now you can just double click on the "bootstra.prg" icon in that folder to 
  411.    actually start the system, booting from the just installed harddisk instead 
  412.    of the ramdisk filesystem.
  413.  
  414.     The boot sequence will take quite a bit longer than when you installed the 
  415.    system because a database of filenames has to be built ("Locate" database). 
  416.    After that, you are automatically logged in, and need to take these steps:
  417.      * Set a password for the root user (the administrator account)
  418.      * Create another (unprivileged) user account
  419.      * Activate (or not) the "Shadow passwords" (recommendation: Yes, use it!)
  420.      * Determine whether you want to continue installing the system via a PPP 
  421.        line or not, and configuration of the PPP connection scripts.
  422.      * Set an "installation profile" of packages you want to install.
  423.  
  424.    After these steps, you are automatically thrown into the "dselect" program 
  425.    which is the interface-driven package installation manager. My personal 
  426.    preference is to quit that program as soon as possible and rather install 
  427.    packages manually via the "apt-get" or "dpkg" program, but your mileage 
  428.    may vary. You should at least set the access method and update the packages 
  429.    list here; I have so far used disk based and HTTP/FTP based installation 
  430.    methods with success. Selection of packages has already been performed if 
  431.    you didn't skip the "installation profile" above, so there should be no 
  432.    need to select packages by hand using dselect.
  433.  
  434.    When you quit this program, you get logged out and can log in as root or as 
  435.    an unprivileged user if you created one before.
  436.  
  437.     At this point you have a running basic Debian installation on your Atari, 
  438.    and if this all worked out (more or less) well for you, I'd definitely love 
  439.    to hear about it! :-)
  440.  
  441.     A few tasks are still left to do, such as configuring PPP or SLIP (if 
  442.    that's your network option and you didn't run the pppconfig step earlier). 
  443.    For PPP, edit /etc/ppp/peers/provider (replace /dev/modem with your serial 
  444.    line here, i.e. /dev/ttyS1 for the first SCC port; there's no /dev/modem 
  445.    anymore) and /etc/chatscripts/provider (enter your username and password 
  446.    for your ISP account, plus change the 'name' and 'word' to whatever the 
  447.    prompt at login is. Some configurations require you to send the string 'ppp' 
  448.    to start up PPP after login, just add another expect/send pair after the 
  449.    password for that. "pon" and "poff" start and stop the connection, 
  450.    respectively. SLIP is more hassle; look at the "/etc/init.d/network" 
  451.    startup script where the "ifconfig" command has already been inserted for 
  452.    you, and add a "slattach" command before this, if you use static SLIP. 
  453.    Dynamic SLIP should be set up using "dip", so you'll need to install this 
  454.    package.
  455.  
  456.     One more hint: To cleanly shut down a running Linux system, you must not 
  457.    just reboot with the reset switch on the back of your Atari, or turn off 
  458.    the computer - instead, press the key combination Ctrl-Alt-Del (yeah, just 
  459.    like on a PC :-) to shut down the system in a controlled manner. That's 
  460.    Ctrl + LeftAlt + Delete_right_of_Return. Or log in as root and type
  461.  
  462.    shutdown -h now
  463.  
  464.    if you don't like the key combo.
  465.  
  466.      ______________________________________________________________________
  467.  
  468.    More information:
  469.  
  470.  
  471.      * The The Debian GNU/Linux homepage (http://www.debian.org/)
  472.      * The Linux/m68k domain's homepage (http://www.linux-m68k.org/)
  473.      * Visit m68k people on IRC, channel #linux68k, server irc.lame.org 
  474.        (or connected servers).
  475.  
  476.    ..and maybe hundreds of other Linux- or Debian-related Web sites around 
  477.    the world.
  478.  
  479.     Good luck in the wonderful world of Debian/m68k!
  480.  
  481. History of this installation guide:
  482. v0.1    July 20th,    1998   First
  483. version, only ASCII text
  484. v1.0    August 3rd,   1998   Pushed to HTML, small additions & typo corrections
  485. Atari version:
  486. v1.0    August 9th,   1998   First version, based on Frank Neumanns Amiga version
  487. v1.4    January 29th, 1999   Update for Debian 2.1
  488. v1.5    February 8th, 1999   Add CD install option
  489. v1.6    May 27th,     1999   Fixed order of netconfig/base steps
  490.  
  491.     Michael Schmitz, Last change:  May 27, 1999
  492.